home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / games / mars.arc / MARS.TXT < prev    next >
Text File  |  1988-03-20  |  8KB  |  203 lines
  1. ========================================================================
  2. === Hello World ========================================================
  3. ========================================================================
  4. 'Core Wars' is a battle between two programs inside your computer. 
  5. The language used to write the programs closely resembles an assembler    
  6. language with a set of 10 instructions.
  7. Our Version 2.1E for the Atari ST is implemented according to the
  8. Core War Standards as of May 21,1986.
  9.  
  10. The Core War Standards are available at the following adress: 
  11.  
  12.      Mark Clarkson
  13.      8619 Wassall Street
  14.      Wichita
  15.      Kansas 67210-1934
  16.      USA
  17.  
  18.      Please enclose a 4-dollar-bill (...oops...)
  19.      
  20. Several articles dealing with Core Wars have been published in 
  21. 'Scientific American'.
  22. In the german edition of 'Scentific American' articels about Core
  23. Wars were published at the following dates: 8/84, 5/85 and 4/87.
  24. Normally the original article is published one or two month before
  25. it is published in Germany.
  26.  
  27.  
  28. ========================================================================
  29. === The following files are included with our version 2.1E =============
  30. ========================================================================
  31.  
  32.  MARS.ARC                 This file contains our MARS program together
  33.                           with BROWSER, an useful accesory, and an EDITOR
  34. BROWSE   ACC    10056     which can be used to write your own battle 
  35. EDITOR   PRG    29250     programs.
  36. MARS     PRG    32129
  37. MARS     RSC     5440
  38. EDITOR   TXT     1741
  39. MARS     TXT     8312
  40.  
  41.                           These are ready-to-load battle programs.
  42. COMMANDO RED      174
  43. FACTA    RED      158
  44. KNIRPS   RED       22
  45. MICE     RED      200
  46. MIDGET   RED      109
  47. MINID    RED       52
  48. NOTHING  RED       36
  49. PARASITE RED      139
  50. ZWILLING RED      315
  51. COMMAND1 RED      333
  52. CHANG1   RED      234
  53. LOCUST   RED      149
  54.  
  55. ========================================================================
  56. ===  MARS operating instructions =====================================
  57. ========================================================================
  58.  
  59.      ============================
  60.      ==  Dropdown-Menu Select  ==
  61.      ============================
  62.  
  63.      Load Programs
  64.      --------------
  65.      ...lets you select the two battle programs, which must have .RED
  66.      as file name extension. The file selector box is shown twice, one
  67.      for each program. Battle programs should not exceed a length of
  68.      10000 bytes of source code including comments. So, if you write very long 
  69.      programs, keep your comments short, else the program won't load.
  70.      Each program is now moved to a random position in memory, and it is
  71.      made sure that they don't overlap. If MARS find an illegal instruction
  72.      it prints an error message and exits, otherwise execution of the
  73.      'battle' starts immediately.  
  74.  
  75.      Setup
  76.      -----   
  77.      ...lets you change some default values such as:
  78.     
  79.      Core Size             sets the size of the 'battle field'
  80.      Instructions          determines the number of instructions executed
  81.                            before the battle stops. A value of e.g. 1000  
  82.                            means that each of the two programs executes
  83.                            500 instructions.
  84.      Repeat                lets you repeat the battle between the same 
  85.                            programs any number of times without you 
  86.                            having to select the programs each time.
  87.                            
  88.      Editor                 
  89.      ------
  90.      ...invokes an editor of your choice. Simply rename your own editor
  91.      to EDITOR.PRG and use it from MARS. We hope that this feature 
  92.      works with most editors, but of course one can never be sure...
  93.      
  94.      Result
  95.      --------
  96.      ...shows the result of the most recent battle.
  97.  
  98.      QUIT      
  99.      ----
  100.      ...quits.      
  101.  
  102.      ==========================
  103.      == Dropdown-Menu Output ==
  104.      ==========================
  105.  
  106.      Text
  107.      ----
  108.      ...lets you watch the battle by printing each instruction currently
  109.      being executed. A single line always shows two instructions, one of
  110.      each program. Pushing any key causes a break in program execution,
  111.      pressing the key again make the battle continue. Push the ESC-key
  112.      to terminate the battle.
  113.  
  114.      Core
  115.      ----
  116.      ...opens a window representing the battle field in which the upper
  117.      left corner is the lowest adress and the bottom right corner the
  118.      highest adress. Inside this window, the first and second program
  119.      are represented by checkered squares and grey squares, respectively.
  120.      With each instruction of either program, a checkered or grey square
  121.      appears at its corresponding position. Additionally, after execution
  122.      of a MOV instruction, a white square appears at the destination 
  123.      adress of the MOV.
  124.  
  125.      Save
  126.      ----
  127.      ...lets you save all printed text output to a disc file named 
  128.      COREWARS.REC. This feature allows for a closer examination of 
  129.      the battle after the 'battle is over', but also slows down 
  130.      execution speed considerably.
  131.  
  132.      ========================
  133.      == Dropdown-Menu MODE ==
  134.      ========================
  135.  
  136.      Single Step
  137.      -----------
  138.      This mode only works while the TEXT window is open. In that case,
  139.      each program executes one instruction, and then MARS waits for you
  140.      to push a key. This repeats every time you push the space bar.
  141.      Pushing any other key turns off single step mode. 
  142.  
  143.      Single Player 
  144.      -------------
  145.      For debugging purposes it can sometimes be useful to just run a
  146.      single program instead of two. Voila, here you go...     
  147.  
  148.      Fixed Adress
  149.      ------------
  150.      If this mode is active the first program is loaded at the lowest
  151.      adress in memory, while the second program is moved to a random
  152.      position. Again, this is sometimes useful for debugging or testing
  153.      your 'warrior'.
  154.  
  155.      WARNING
  156.      -------
  157.      If this mode is selected and the interpreter comes across an illegal
  158.      adressing mode or operand, it prints a warning message as usual, but
  159.      continues to read the rest of the source. This makes it possible to
  160.      make your 'warrior' behave in ways different from those provided by
  161.      the regular instruction set. However, try to avoid this programming
  162.      style, since the programms using this feature might not behave the
  163.      same on all versions of 'Core Wars'.
  164.      
  165.      Syntax
  166.      ------
  167.      ...shows you the REDCODE instruction set and syntax.
  168.  
  169.      ===================================================================
  170.      == ESC-key   ======================================================
  171.      ===================================================================
  172.      
  173.      Anytime you wish to interrupt an ongoing battle, simply push the
  174.      ESC-key.
  175.  
  176.      Although our version of CORE WARS is otherwise close to perfect
  177.      ( isn't it ?!?) , it does not provide for arithmetic operations 
  178.      on labels and operands. Sorry, but you'll just have to live with 
  179.      it...
  180.  
  181.  
  182.     
  183. ========================================================================
  184. === Additional programs   ==============================================
  185. ========================================================================
  186. In the MARS directory you find an editor named EDITOR.PRG. It was written
  187. by U. Romahn and is a public domain program. Unfortunately for you
  188. ladies and gentlemen out there, this is a German program and therefore 
  189. the messages are printed in German. File EDITOR.TXT contains some 
  190. operating instructions to help you with this problem.
  191.  
  192. Another excellent little accessory, BROWSE.ACC, can be used to have a
  193. look at text files. It shows all characters including line feeds and
  194. carriage return. Push the HELP key for more information.
  195.  
  196.      A note on labels:
  197.  
  198.      While in executing mode, MARS tries to find a label named START
  199.      an